package com.minimalist.common.feign.client.lindi;

import cn.dev33.satoken.annotation.SaCheckPermission;
import com.minimalist.common.config.mybatis.bo.PageResp;
import com.minimalist.common.entity.lindi.vo.contracttemplate.LindiContractTemplateQueryVO;
import com.minimalist.common.entity.lindi.vo.contracttemplate.LindiContractTemplateVO;
import com.minimalist.common.feign.config.FeignConfig;
import com.minimalist.common.feign.fallback.lindi.LindiContractTemplateFeignClientFallbackFactory;
import com.minimalist.common.response.R;
import com.minimalist.common.utils.Add;
import com.minimalist.common.utils.Update;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import jakarta.validation.constraints.NotNull;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

/**
 * 林地指标平台_合同模板 Feign 客户端
 *
 * @author 11987
 */
@FeignClient(name = "minimalist-lindi"
        , contextId = "lindiContractTemplateFeignClient"
        , path = "/minimalist/lindi/contractTemplate"
        , configuration = FeignConfig.class
        , fallbackFactory = LindiContractTemplateFeignClientFallbackFactory.class)
public interface LindiContractTemplateFeignClient{
    /**
     * 添加合同模板
     *
     * @param contractTemplateVO 合同模板信息
     * @return 成功或失败
     */
    @PostMapping("/addContractTemplate")
    @Operation(summary = "添加合同模板")
    R<?> addContractTemplate(
            @RequestBody @Validated(Add.class)
            LindiContractTemplateVO contractTemplateVO);

    /**
     * 删除合同模板 -> 根据合同模板ID删除
     *
     * @param contractTemplateId 合同模板ID
     * @return 成功或失败
     */
    @DeleteMapping("/deleteContractTemplateByContractTemplateId")
    @Operation(summary = "删除合同模板 -> 根据合同模板ID删除")
    R<?> deleteContractTemplateByContractTemplateId(
            @RequestParam("contractTemplateId")
            @NotNull(message = "合同模板ID不能为空")
            @Parameter(name = "contractTemplateId", required = true, description = "合同模板ID")
            Long contractTemplateId);

    /**
     * 修改合同模板
     *
     * @param contractTemplateVO 合同模板信息
     * @return 成功或失败
     */
    @PutMapping("/updateContractTemplateByContractTemplateId")
    @Operation(summary = "修改合同模板")
    R<?> updateContractTemplateByContractTemplateId(
            @RequestBody @Validated(Update.class)
            LindiContractTemplateVO contractTemplateVO);

    /**
     * 查询合同模板列表(分页)
     *
     * @param queryVO 查询条件
     * @return 合同模板列表
     */
    @GetMapping("/getPageContractTemplateList")
    @Operation(summary = "查询合同模板列表(分页)")
    R<PageResp<LindiContractTemplateVO>> getPageContractTemplateList(
            @RequestBody LindiContractTemplateQueryVO queryVO);

    /**
     * 根据合同模板ID查询合同模板
     *
     * @param contractTemplateId 合同模板ID
     * @return 合同模板
     */
    @GetMapping("/getContractTemplateByContractTemplateId/{contractTemplateId}")
    @Operation(summary = "根据合同模板ID查询合同模板")
    R<LindiContractTemplateVO> getContractTemplateByContractTemplateId(
            @PathVariable(value = "contractTemplateId")
            @NotNull(message = "合同模板ID不能为空")
            @Parameter(name = "contractTemplateId", description = "合同模板ID", required = true)
            Long contractTemplateId);

    /**
     * 删除合同模板文件 -> 根据合同模板文件ID删除
     *
     * @param fileId 合同模板文件ID
     * @return 删除结果
     */
    @PostMapping("/deleteContractTemplateFileByFileId")
    @Operation(summary = "删除合同模板文件 -> 根据合同模板文件ID删除")
    @SaCheckPermission("lindi:contractTemplate:delete")
    public R<?> deleteContractTemplateFileByFileId(
            @RequestParam("fileId") @NotNull(message = "合同模板文件ID不能为空")
            @Parameter(name = "fileId", required = true, description = "合同模板文件ID")
            Long fileId);
}